Obtains a handle to a picture stored in a 'PICT' resource.

PicHandle GetPicture (
    SInt16 pictureID
);

Parameter descriptions

pictureID

The resource ID for a 'PICT' resource.

function result

A handle to the picture in the specified ëPICT’ resource. To draw the picture stored in the resource, pass this handle to the DrawPicture function. If the resource cannot be read, GetPicture returns NULL.

DISCUSSION

The GetPicture function calls the Resource Manager function GetResource as follows:

GetResource(ëPICT’, picID)

SPECIAL CONSIDERATIONS

To release the memory occupied by a picture stored in a 'PICT' resource, use the Resource Manager function ReleaseResource.

The GetPicture function may move or purge memory.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)